Cairo bindings

Rust bindings for Rust and wrappers for Cairo, part of gtk-rs-core.

Cairo 1.14 is the lowest supported version for the underlying library.

Minimum supported Rust version

Currently, the minimum supported Rust version is 1.63.0.

Default-on features

• use_glib - Use with glib

Fileformat features

• png - Reading and writing PNG images
• pdf - Rendering PDF documents
• svg - Rendering SVG documents
• ps - Rendering PostScript documents

Cairo API version features

• v1_16 - Use Cairo 1.16 APIs

Documentation

• Rust API - Stable
• Rust API - Development
• C API

Documentation features

• dox - Used to keep system dependent items in documentation

X Window features

• xcb - X Window System rendering using the XCB library
• xlib - X Window System rendering using XLib

Windows API features

• win32-surface - Microsoft Windows surface support

Using

We recommend using crates from crates.io, as demonstrated here.

If you want to track the bleeding edge, use the git dependency instead:

[dependencies]
cairo-rs = { git = "https://github.com/gtk-rs/gtk-rs-core.git", package = "cairo-rs" }

Avoid mixing versioned and git crates like this:

# This will not compile
[dependencies]
cairo-rs = "0.13"
cairo-rs = { git = "https://github.com/gtk-rs/gtk-rs-core.git", package = "cairo-rs" }

See Also

• glib

License

cairo is available under the MIT License, please refer to it.